@turf/destination

What is @turf/destination?

@turf/destination is a module from the Turf.js library that allows you to calculate the destination point given a starting point, distance, and bearing. It is useful for geospatial analysis and manipulation, particularly in applications involving mapping, navigation, and geographic data processing.

What are @turf/destination's main functionalities?

Calculate Destination Point

This feature allows you to calculate the destination point from a given starting point, distance, and bearing. The code sample demonstrates how to use the @turf/destination module to find a point 50 miles east of the starting point.

const turf = require('@turf/turf');

const start = turf.point([-75.343, 39.984]);
const distance = 50;
const bearing = 90;
const options = {units: 'miles'};

const destination = turf.destination(start, distance, bearing, options);
console.log(destination);

Other packages similar to @turf/destination

geolib

Geolib is a library for geospatial calculations in JavaScript. It provides similar functionalities to @turf/destination, such as calculating distances, bearings, and destination points. However, Geolib is a more general-purpose library for geospatial calculations, whereas @turf/destination is part of the Turf.js library, which is specifically designed for advanced geospatial analysis.

geodesy

Geodesy is a library for geodesic calculations in JavaScript. It offers functionalities for calculating distances, bearings, and destination points, similar to @turf/destination. Geodesy focuses on precise geodesic calculations, making it suitable for applications requiring high accuracy. In comparison, @turf/destination is part of the Turf.js library, which provides a broader range of geospatial analysis tools.

README

@turf/destination

destination

Takes a Point and calculates the location of a destination point given a distance in degrees, radians, miles, or kilometers; and bearing in degrees. This uses the Haversine formula to account for global curvature.

Parameters

• origin Coord starting point
• distance number distance from the origin point
• bearing number ranging from -180 to 180
• options Object Optional parameters (optional, default {})
  • options.units string miles, kilometers, degrees, or radians (optional, default 'kilometers')
  • options.properties Object Translate properties to Point (optional, default {})

Examples

var point = turf.point([-75.343, 39.984]);
var distance = 50;
var bearing = 90;
var options = {units: 'miles'};

var destination = turf.destination(point, distance, bearing, options);

//addToMap
var addToMap = [point, destination]
destination.properties['marker-color'] = '#f00';
point.properties['marker-color'] = '#0f0';

Returns Feature<Point> destination point

---

This module is part of the Turfjs project, an open source module collection dedicated to geographic algorithms. It is maintained in the Turfjs/turf repository, where you can create PRs and issues.

Installation

Install this module individually:

$ npm install @turf/destination

Or install the Turf module that includes it as a function:

$ npm install @turf/turf

Changelog

6.5.0

🏅 New Features/Enhancements

• @turf/points-with-polygon Add MultiPoint support (PR https://github.com/Turfjs/turf/pull/2137 - Author @twelch)

🐛 Bug Fixes

• @turf/dissolve Complete rewrite of the dissolve module to resolve many bugs (PR https://github.com/Turfjs/turf/pull/2110 - Author @rowanwins)

• @turf/mask Complete rewrite of the mask module to resolve many bugs (PR https://github.com/Turfjs/turf/pull/2130 - Author @rowanwins)

• @turf/boolean-valid Add missing dependency to (PR https://github.com/Turfjs/turf/pull/2094 - Author @rycgar)

📖 Documentation

• @turf/boolean-overlap Improve clarity (PR https://github.com/Turfjs/turf/pull/2133 - Author @patrickbrett)

🔔 Misc

• Enable TS Strict Mode (PR https://github.com/Turfjs/turf/pull/2126 - Author @mfedderly)